Add Qdrant MCP server configuration. #83
Draft
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…nt formatting for examples, and adjust defaults.
…emove unused fastmcp_host/port settings, and include FASTEMBED_CACHE_PATH.
|
Thank you for your contirbution! This is the result of running Could you make that listing tools does not need any configuration, please? we only push to hub docker images that succesfully list tools. |
|
The issue at hand is that the Qdrant MCP requires either the |
…model, use consistent formatting for examples, and revise default values.
…r environment variables.
…ng for example values.
…or QDRANT_LOCAL_PATH.
MH0386
commented
Jul 25, 2025
Comment on lines
+33
to
+41
| - name: QDRANT_URL | ||
| example: 'http://localhost:6333' | ||
| value: '{{qdrant.qdrant_url}}' | ||
| - name: COLLECTION_NAME | ||
| example: 'my-collection' | ||
| value: '{{qdrant.collection_name}}' | ||
| - name: QDRANT_LOCAL_PATH | ||
| example: 'None' | ||
| value: '{{qdrant.qdrant_local_path}}' |
There was a problem hiding this comment.
I would like to address an issue I encountered regarding the configuration file server.yaml for the Docker MCP Registry. This file is required to specify all environment variables (options) for the Qdrant MCP.
The first concern is that both QDRANT_URL (referred to as location) and QDRANT_LOCAL_PATH (referred to as local_path) are set simultaneously. This configuration has led to a validation error, as it is not permissible to provide both options at the same time.
The validation error is as follows:
Traceback (most recent call last):
File "/root/.cache/uv/archive-v0/SZ7ANpRs8hfrR56uyvt3d/bin/mcp-server-qdrant", line 12, in <module>
sys.exit(main())
^^^^^^
File "/root/.cache/uv/archive-v0/SZ7ANpRs8hfrR56uyvt3d/lib/python3.11/site-packages/mcp_server_qdrant/main.py", line 22, in main
from mcp_server_qdrant.server import mcp
File "/root/.cache/uv/archive-v0/SZ7ANpRs8hfrR56uyvt3d/lib/python3.11/site-packages/mcp_server_qdrant/server.py", line 10, in <module>
qdrant_settings=QdrantSettings(),
^^^^^^^^^^^^^^^^
File "/root/.cache/uv/archive-v0/SZ7ANpRs8hfrR56uyvt3d/lib/python3.11/site-packages/pydantic_settings/main.py", line 188, in __init__
super().__init__(
File "/root/.cache/uv/archive-v0/SZ7ANpRs8hfrR56uyvt3d/lib/python3.11/site-packages/pydantic/main.py", line 253, in __init__
validated_self = self.__pydantic_validator__.validate_python(data, self_instance=self)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
pydantic_core._pydantic_core.ValidationError: 1 validation error for QdrantSettings
Value error, if 'local_path' is set, 'location' and 'api_key' must be None. [type=value_error, input_value={'QDRANT_URL': 'http://lo...ath/to/qdrant/database'}, input_type=dict]
For further information, visit https://errors.pydantic.dev/2.11/v/value_error
exit status 1
Additionally, the QDRANT_LOCAL_PATH variable is mistakenly set to the string 'None', which is not equivalent to the actual None value in Python. This can further contribute to validation issues.
To resolve this matter, I have submitted a pull request to the Qdrant MCP repository.
I will provide updates as soon as the issue has been addressed. Thank you for your attention to this matter.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This pull request introduces a new server configuration for Qdrant, a high-performance vector database and search engine, by adding a
server.yamlfile. The file defines metadata, runtime settings, environment variables, and configuration parameters required to integrate Qdrant into the system.New Qdrant Server Configuration:
Metadata and About Section: Added metadata for the Qdrant server, including its name, category (
database), tags, and a description highlighting its capabilities as a vector database and search engine.Runtime Configuration: Defined the runtime command (
uvx mcp-server-qdrant) and a volume mapping for the embedding model cache (fastembed_model:/hf).Environment Variables: Introduced environment variables for configuring Qdrant, such as
QDRANT_URL,COLLECTION_NAME,EMBEDDING_PROVIDER, and logging/debug settings (FASTMCP_LOG_LEVEL,FASTMCP_DEBUG, etc.).Configurable Parameters: Added parameters for Qdrant connection settings (e.g.,
qdrant_url,collection_name,embedding_model) and server behavior (e.g., logging level, debug mode, warnings for duplicates). Some parameters include default values, andcollection_nameis required.